<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8"/>
        <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>
        <title>AJ Utils-JsonUtil 教程</title>
        <meta name="description" content="Small Java utilities with many useful functions.  为 Java 应用程序中的 JSON 数据处理提供实用方法" />
        <meta name="keywords" content="AJ Utils, ajaxjs, ajaxjs framework, java utilities, tools, helper, JSON,序列化,Java" />
        <meta name="viewport" content="width=device-width, initial-scale=1"/>
        <link rel="preconnect" href="https://fonts.googleapis.com" />
        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
        <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Noto+Serif+SC:wght@200..900&family=Noto+Serif:ital,wght@0,100..900;1,100..900&display=swap&family=Noto+Sans+SC:wght@100..900&display=swap" />
        <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@100..900&family=Noto+Serif:ital,wght@0,100..900;1,100..900&display=swap" /> 
        <link rel="stylesheet" href="https://framework.ajaxjs.com/static/new-ui/css/common.css" />
        <link rel="stylesheet" href="https://iam.ajaxjs.com/asset/main.css"/>
        <link rel="icon" type="image/x-icon" href="https://framework.ajaxjs.com/aj-logo/logo.ico"/>
        <script src="https://framework.ajaxjs.com/static/aj-docs/common.js"></script>
        <script>
            var _hmt = _hmt || [];
            (function() {
              var hm = document.createElement("script");
              hm.src = "https://hm.baidu.com/hm.js?208c5aea11c52991bd1c3283e62ad0ce";
              var s = document.getElementsByTagName("script")[0];
              s.parentNode.insertBefore(hm, s);
            })();
        </script>
    </head>
    <body>
        <nav>
            <div>
                <div class="links">
                    <a href="/cn">🏠 首页</a>
                    | ⚙️ 源码:
                    <a target="_blank" href="https://github.com/lightweight-component/aj-util">Github</a>/<a target="_blank" href="https://gitcode.com/lightweight-component/aj-util">Gitcode</a>
                  
                    | 🚀<a href="">英语版本</a>
                </div>
                <h1>
                    <img src="https://framework.ajaxjs.com/aj-logo/logo.png" style="vertical-align: middle;height: 45px;margin-bottom: 6px;" />
                    AJ Utils
                </h1>
                <h3>小型、干净、简单的 Java 工具库
                </h3>
            </div>
        </nav>
        <div>
            <menu>
                
                <ul>
                    <li class="selected">
                        <a href="/cn">首页</a>
                    </li>
                </ul>
                <h3>Common 常用模块</h3>
                <ul>
                    <li><a href="/common/JsonUtil-cn/">JsonUtil</a></li>
                    <li><a href="/common/Base64Helper-cn/">Base64Helper</a></li>
                    <li><a href="/common/ConvertBasicValue-cn/">ConvertBasicValue</a></li>
                    <li><a href="/common/MessageDigestHelper-cn/">HashHelper</a></li>
                    <li><a href="/common/MapTool-cn/">MapTool</a></li>
                    <li><a href="/common/ObjectHelper-cn/">ObjectHelper</a></li>
                    <li><a href="/common/RandomTools-cn/">RandomTools</a></li>
                    <li><a href="/common/RegExpUtils-cn/">RegExpUtils</a></li>
                    <li><a href="/common/StrUtil-cn/">StrUtil</a></li>
                    <li><a href="/common/BoxLogger-cn/">BoxLogger</a></li>
                    <li><a href="/common/BytesHelper-cn/">BytesHelper</a></li>
                    <li><a href="/common/EncodeTools-cn/">UrlEncode</a></li>
                    <li><a href="/common/XmlHelper-cn/">XmlHelper</a></li>
                    <li><a href="/common/WebUtils-cn/">WebUtils</a></li>
                </ul>
                <h3>Date 日期处理</h3>
                <ul>
                    <li><a href="/date/intro-cn/">简介</a></li>
                    <li><a href="/date/convert-cn/">万能日期类型转换</a></li>
                    <li><a href="/date/formatter-cn/">日期格式化</a></li>
                </ul>
                <h3>Reflection 反射</h3>
                <ul>
                    <li><a href="/reflect/Methods-cn/">Methods</a></li>
                    <li><a href="/reflect/Types-cn/">Types</a></li>
                    <li><a href="/reflect/Clazz-cn/">Clazz</a></li>
                </ul>

                <h3>Input/Output 输入/输出</h3>
                <ul>
                    <li><a href="/io/FileHelper-cn/">FileHelper</a></li>
                    <li><a href="/io/Resources-cn/">Resources</a></li>
                    <li><a href="/io/StreamHelper-cn/">DataReader/DataWriter</a></li>
                    <li><a href="/io/ZipHelper-cn/">ZipHelper</a></li>
                </ul>

                <h3>HTTP 请求</h3>
                <ul>
                    <li><a href="/http_request/Get-cn">HTTP 请求</a></li>
                     <li><a href="/http_request/advanced-usage-cn/">高级用法</a></li>
                    <li><a href="/http_request/Base-cn/">Base</a></li>
                </ul>

                <h3>加密/解密</h3>
                <ul>
                    <li><a href="/cryptography/intro-cn/">简介</a></li>
                    <li><a href="/cryptography/flow-cn/">基本流程</a></li>
                    <li><a href="/cryptography/AesCrypto-cn/">AES/DES 加密解密</a></li>
                    <li><a href="/cryptography/RsaCrypto-cn/">RSA 加密解密</a></li>
                </ul>
            </menu>
            <article class="aj-text chinese">
                <h1>JsonUtil 教程</h1>
<p>本教程提供了 <code>JsonUtil</code> 类的概述，该类是 <code>lightweight-component/aj-util</code> 库的一部分。<code>JsonUtil</code> 类为 Java 应用程序中的 JSON 数据处理提供了实用工具方法。</p>
<h2>简介</h2>
<p><code>JsonUtil</code> 类包含使用 Jackson 库的静态方法，用于常见的 JSON 操作，包括 JSON 字符串、Java 对象、Map 和 List 之间的转换。</p>
<h2>主要特性</h2>
<ul>
<li>将 Java 对象转换为 JSON 字符串（美化或紧凑格式）</li>
<li>将 JSON 字符串解析为 Java 对象</li>
<li>JSON 与 Map/List 之间的转换</li>
<li>类型安全的 JSON 处理</li>
<li>Java 8 日期/时间支持</li>
<li>严格的重复检测</li>
</ul>
<h2>方法</h2>
<h3>1. 序列化 (转 JSON)</h3>
<ol>
<li><code>toJson(Object obj)</code> - 将对象转换为 JSON 字符串</li>
<li><code>toJsonPretty(Object obj)</code> - 将对象转换为美化格式的 JSON</li>
</ol>
<h3>2. 反序列化 (从 JSON)</h3>
<ol>
<li><code>fromJson(String jsonStr, Class&lt;T&gt; valueType)</code> - 将 JSON 解析为指定类型</li>
<li><code>fromJson(String jsonStr, JavaType valueType)</code> - 将 JSON 解析为复杂类型</li>
</ol>
<h3>3. JSON ↔ Map 转换</h3>
<ol>
<li><code>json2map(String jsonStr)</code> - JSON 转 Map&lt;String, Object&gt;</li>
<li><code>json2map(String jsonStr, Class&lt;T&gt; clazz)</code> - JSON 转带类型值的 Map</li>
<li><code>json2sortMap(String jsonStr, Class&lt;T&gt; clazz)</code> - JSON 转保留顺序的 LinkedHashMap</li>
<li><code>json2StrMap(String jsonStr)</code> - JSON 转 Map&lt;String, String&gt;</li>
</ol>
<h3>4. JSON ↔ List 转换</h3>
<ol>
<li><code>json2list(String jsonArrayStr, Class&lt;T&gt; clazz)</code> - JSON 数组转 List<T></li>
<li><code>json2mapList(String jsonArrayStr)</code> - JSON 数组转 List<Map></li>
</ol>
<h3>5. 对象转换</h3>
<ol>
<li><code>convertValue(Object obj, Class&lt;T&gt; clazz)</code> - 转换对象类型</li>
<li><code>pojo2map(Object obj)</code> - POJO 转 Map</li>
<li><code>pojo2map(Object obj, Class&lt;T&gt; clazz)</code> - POJO 转带类型的 Map</li>
<li><code>map2pojo(Map&lt;String, Object&gt; map, Class&lt;T&gt; clazz)</code> - Map 转 POJO</li>
</ol>
<h3>6. JSON 树模型</h3>
<ol>
<li><code>json2Node(String jsonStr)</code> - 将 JSON 解析为 JsonNode 树</li>
</ol>
<h2>使用示例</h2>
<h3>基本序列化</h3>
<pre><code class="language-java">User user = new User(&quot;John&quot;, 30);
String json = JsonUtil.toJson(user); 
// {&quot;name&quot;:&quot;John&quot;,&quot;age&quot;:30}

String prettyJson = JsonUtil.toJsonPretty(user);
/*
{
  &quot;name&quot; : &quot;John&quot;,
  &quot;age&quot; : 30
}
*/
</code></pre>
<h3>基本反序列化</h3>
<pre><code class="language-java">String json = &quot;{\&quot;name\&quot;:\&quot;John\&quot;,\&quot;age\&quot;:30}&quot;;
User user = JsonUtil.fromJson(json, User.class);
</code></pre>
<h3>Map 转换</h3>
<pre><code class="language-java">Map&lt;String, Object&gt; map = new HashMap&lt;&gt;();
map.put(&quot;name&quot;, &quot;John&quot;);
map.put(&quot;age&quot;, 30);

String json = JsonUtil.toJson(map);
Map&lt;String, Object&gt; map2 = JsonUtil.json2map(json);
</code></pre>
<h3>List 转换</h3>
<pre><code class="language-java">String jsonArray = &quot;[{\&quot;name\&quot;:\&quot;John\&quot;}, {\&quot;name\&quot;:\&quot;Alice\&quot;}]&quot;;
List&lt;User&gt; users = JsonUtil.json2list(jsonArray, User.class);
</code></pre>
<h2>配置</h2>
<p><code>JsonUtil</code> 类预配置了：</p>
<ul>
<li>Java 8 日期/时间支持</li>
<li>严格的重复检测</li>
<li>亚洲/上海时区</li>
<li>默认的 ObjectMapper 实例</li>
</ul>
<h2>结论</h2>
<p><code>JsonUtil</code> 类提供了全面的实用方法，用于处理 JSON 数据，使序列化、反序列化以及 JSON 与 Java 对象之间的转换更加容易。</p>

            </article>
        </div>

       <footer>
            AJ-Util，开源框架 <a href="https://framework.ajaxjs.com" target="_blank">AJ-Framework</a> 的一部分。联系方式：
            frank@ajaxjs.com，<a href="https://blog.csdn.net/zhangxin09" target="_blank">作者博客</a>
            <br />
            <br />
            Copyright © 2025 Frank Cheung. All rights reserved.
        </footer>
    </body>
</html>